Node / meshtastic / Meshtastic-Android / files / docs / zh-rTW / user / node-metrics.md

Displaying Rendered • View raw • Download

title: Node Metrics

parent: User Guide

nav_order: 5

last_updated: 2026-07-08

description: Telemetry dashboards for each mesh node — device health, environment sensors, air quality, signal quality, power, traceroute, and position history.

aliases:

• metrics

• 遙測

• device-metrics

• signal

The node detail screen provides comprehensive telemetry and metrics for each node on your mesh.

Basic operating information reported by each node:

Device metrics are displayed as individual cards with trend sparklines showing battery level, voltage, channel utilization, airtime, and uptime over time.

│ 💡 Tip: Tap any metric card to expand it into a full chart with historical data points. Pinch to

│ zoom the time axis.

Environmental sensor data (requires compatible hardware):

Environment metrics are charted over time for easy trend analysis — temperature, humidity, and pressure each get their own line chart with the measurement unit displayed on the Y axis.

The BME680 IAQ (Indoor Air Quality) index is a single 0–500+ value derived from gas resistance, shown against a color-coded scale from Excellent to Dangerously Polluted:

!IAQ index scale from Excellent to Dangerously Polluted

│ 💡 Tip: Environment metrics require a sensor connected to the remote node. Not all nodes report

│ environmental data. See Telemetry & │ Sensors

│ for a full list of supported sensors.

Air Quality is a dedicated metrics view for nodes equipped with a particulate-matter and/or CO₂ sensor. It is separate from the BME680 IAQ reading listed under Environment Metrics — IAQ is a single gas-resistance-derived index, while the Air Quality view charts the underlying particulate and CO₂ measurements.

CO₂ readings are color-coded by severity to make air quality easy to read at a glance:

!Air quality readings with color-coded CO₂ severity

An air-quality log/metrics button appears on the node detail screen only when the node has reported air-quality telemetry. From the Air Quality view you can:

• Select a time frame for the charts.

• Filter with metric chips — only metrics that have data are shown.

• Refresh / request the latest air-quality telemetry.

• Export to CSV for analysis in a spreadsheet.

│ 💡 Tip: Air Quality metrics require a compatible air-quality sensor on the remote node. If a node

│ has no particulate or CO₂ sensor, the air-quality button won't appear. See Telemetry & │ Sensors

│ for supported hardware.

Radio signal quality information:

Signal quality is rated from SNR relative to the active LoRa modem preset's demodulation floor, not from fixed thresholds — a given SNR means different things on different presets (e.g. −15 dB is fine on LongSlow but unusable on ShortFast). RSSI is shown but is not part of the rating. Letting T383838limit be the preset's SNR limit:

See Understanding the Signal Meter for the full explanation.

Local Stats from your connected radio are also shown in Signal Quality when available. These logs include noise floor, traffic counters, relay counters, online node counts, and radio uptime. The noise floor chart uses a dashed reference line at -85 dBm to help identify a busy RF environment. Use Request to ask the connected radio for a fresh Local Stats telemetry report, Clear to remove Local Stats logs for that node, and Save to export the visible Local Stats history as CSV.

Power management telemetry (requires INA sensor or compatible hardware):

Traceroute shows the path a message takes through the mesh:

1. From the node detail screen, tap Traceroute.

2. The app sends a traceroute request to the target node.

3. Results show each hop with SNR/RSSI values.

T282828

Each hop represents a relay node that forwarded the message.

Historical position data for nodes that share their location:

• GPS coordinates

• 海拔高度

• Speed (if moving)

• Timestamp for each position report

Shows which nodes a given node can directly hear, useful for understanding mesh topology.

1. Navigate to Nodes.

2. Tap the node you want to inspect.

3. Select the metric category from the detail tabs.

!Node detail — local device

The position tab shows location data for nodes that share GPS:

!Position inline content

│ ⚠️ Note: Metrics are only available when they have been reported by the remote node. Metrics

│ update at intervals configured on each node's telemetry settings.

• Nodes — node list, filtering, and sorting

• Telemetry & Sensors — supported sensors and configuration

• Signal Meter — how signal quality is calculated from SNR and RSSI

• Discovery — traceroute details and neighbor info

• Units & Locale — temperature, distance, and speed display formats